home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / GetRootCrd.3 < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. Tk_GetRootCoords(3)   Tk Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tk_GetRootCoords - Compute root-window coordinates of window
  12.  
  13. SYNOPSIS
  14.      #include <tk.h>
  15.  
  16.      Tk_GetRootCoords(_t_k_w_i_n, _x_P_t_r, _y_P_t_r)
  17.  
  18. ARGUMENTS
  19.      Tk_Window   _t_k_w_i_n   (in)      Token for window.
  20.  
  21.      int         *_x_P_t_r   (out)     Pointer to location  in  which
  22.                                    to    store   root-window   x-
  23.                                    coordinate  corresponding   to
  24.                                    left edge of _t_k_w_i_n's border.
  25.  
  26.      int         *_y_P_t_r   (out)     Pointer to location  in  which
  27.                                    to    store   root-window   y-
  28.                                    coordinate  corresponding   to
  29.                                    top edge of _t_k_w_i_n's border.
  30. _________________________________________________________________
  31.  
  32.  
  33. DESCRIPTION
  34.      This procedure  scans  through  the  structural  information
  35.      maintained  by  Tk  to  compute  the root-window coordinates
  36.      corresponding to the upper-left corner  of  _t_k_w_i_n's  border.
  37.      If  _t_k_w_i_n  has  no border, then Tk_GetRootCoords returns the
  38.      root-window coordinates corresponding to location  (0,0)  in
  39.      _t_k_w_i_n.   Tk_GetRootCoords  is relatively efficient, since it
  40.      doesn't have to communicate with the X server.
  41.  
  42.  
  43. KEYWORDS
  44.      coordinates, root window
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.